home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / workbench werkzeuge / wbgames / crossword / cwp.doc < prev    next >
Text File  |  1996-04-07  |  4KB  |  82 lines
  1. CWP -- A crossword puzzle time-waster  by Mike Epting, Cupertino, CA.
  2.  
  3. I can't imagine that you really need any documentation to use this 
  4. program with the puzzles provided, but it is possible that you could 
  5. have trouble getting started.  There are four possible ways to 
  6. successfully run CWP:
  7.  
  8. 1.  Click on a puzzle file icon, hold down the shift key, and double click 
  9.     on the CWP icon.  The selected puzzle will appear.
  10.     
  11. 2.  Double click on a puzzle icon.  This approach works if the icon's tool 
  12.     type is CWP, as with the puzzles provided.
  13.     
  14. 3.  Double click the CWP icon and choose a puzzle file by using the ARP 
  15.     file requestor.  This method is available to you only if you have 
  16.     arp.library installed in your LIBS: directory.  If this makes no sense,
  17.     forget it or get ARP somewhere.
  18.  
  19. 4.  From the CLI, use "CWP filename".  You don't need to type the ".cwp" 
  20.     part of the filename.  Note that if you omit the filename and have 
  21.     arp.library, the arp file requestor will appear.
  22.  
  23. You'll note that small puzzles open up on the Workbench screen, but larger
  24. ones get a custom interlaced screen.  I'm sorry about the crummy colors on
  25. the latter -- I don't have a flicker-fixer and these colors are tolerable
  26. on my Amiga.
  27.  
  28. Once you have a puzzle, just type your guesses.  You can move the cursor 
  29. around by using the keyboard cursor controls or by pointing and clicking.
  30. You can get a single letter hint or check your solution at any time by
  31. using the menu or keyboard substitutes (right-Amiga-H or -C).  If you wish
  32. to save a partial solution, use the menu or right-Amiga S.  Later, you can
  33. bring up the blank puzzle and use Restore to get back to where you left 
  34. off.
  35.  
  36. I wrote the program (it's my first C project -- I hope you can't tell), but
  37. the puzzles are from here and there.  As the author, I guess I have the 
  38. right to make the program public domain, so use it any way you please.  
  39.  
  40. You can enter your own puzzles using any text editor, but I'm real picky 
  41. about format.  Take a look at any of the provided puzzle files to see how 
  42. yours needs to look.
  43.  
  44. The first line is the height and width of the puzzle, in squares, separated
  45. by a comma (e.g. 13, 13).  
  46.  
  47. The next lines are the puzzle solution.  You can use either upper or lower 
  48. case letters, but be careful about spaces.  To make this thing square you 
  49. probably need spaces at the ends of some lines.
  50.  
  51. After the solution, you need a line that says only:  Across:
  52.  
  53. Next are the coordinates and text of the across clues.  First enter the 
  54. horizontal and vertical coordinates; for example, the upper left hand 
  55. square is 1,1.  The fifth square from the left, four down is 5,4.
  56. The clue itself may include any text you wish, but must fit on one line. 
  57. The total line must look like:
  58. x,y,Here is the across clue for square x,y.
  59.  
  60. After all the across clues you need a line with just:  Down:
  61. Then enter the down clues in the same format as the across clues.
  62.  
  63. After you enter a puzzle file, you need to carefully debug it by running 
  64. CWP, positioning the cursor on each square, and checking that the proper 
  65. across and down clues are displayed.  Check especially for blank clues, 
  66. because they suggest that you made a mistake on the coordinates.  I admit
  67. that I have not thoroughly tested CWP with every kind of possible error
  68. in puzzle files, so you might meet the Guru if you are careless with
  69. your puzzle entry.
  70.  
  71. Note that if you want to use method 2, above, you need to either copy my
  72. puzzle icon for your file or edit your icon's tool type.
  73.  
  74. When you have a few good legal puzzles, I'd appreciate it if you make them 
  75. available to the rest of us.  If you upload them to Genie, the Mission 
  76. (415-967-2021), or BBS-JC (415-961-7250), I will get them, consolidate them
  77. and pass them along.  
  78.  
  79. The same three places are also good ways to let me know about bugs.  This
  80. stuff has been tested only on my A1000 so far, so there might be some.
  81.  
  82.                                    Mike Epting